logo头像

学如逆水行舟

iOS UISegmentedControl

SegmentedControl又被称作分段控制器,是IOS开发中经常用到的一个UI控件。

初始化方法:传入的数组可以是字符串也可以是UIImage对象的图片数组

  • (instancetype)initWithItems:(NSArray *)items;

设置控件风格:

@property(nonatomic) UISegmentedControlStyle segmentedControlStyle

注意:这个属性已经废弃,不再起任何作用,它的枚举如下:

typedef NS_ENUM(NSInteger, UISegmentedControlStyle) {
UISegmentedControlStylePlain, // large plain
UISegmentedControlStyleBordered, // large bordered
UISegmentedControlStyleBar, // small button/nav bar style. tintable
UISegmentedControlStyleBezeled, // DEPRECATED. Do not use this style.
} NS_DEPRECATED_IOS(2_0, 7_0, “The segmentedControlStyle property no longer has any effect”);

设置是否保持选中状态:

@property(nonatomic,getter=isMomentary) BOOL momentary;

注意:如果设置为YES,点击结束后,将不保持选中状态,默认为NO

获取标签个数:(只读)

@property(nonatomic,readonly) NSUInteger numberOfSegments;

设置标签宽度是否随内容自适应:

@property(nonatomic) BOOL apportionsSegmentWidthsByContent;

注意:如果设置为NO,则所有标签宽度一致,为最大宽度。

插入文字标签在index位置:

  • (void)insertSegmentWithTitle:(NSString *)title atIndex:(NSUInteger)segment animated:(BOOL)animated

插入图片标签在index位置

  • (void)insertSegmentWithImage:(UIImage *)image atIndex:(NSUInteger)segment animated:(BOOL)animated

根据索引删除标签

  • (void)removeSegmentAtIndex:(NSUInteger)segment animated:(BOOL)animated;

删除所有标签

  • (void)removeAllSegments;

重设标签标题

  • (void)setTitle:(NSString *)title forSegmentAtIndex:(NSUInteger)segment;

获取标签标题

  • (NSString *)titleForSegmentAtIndex:(NSUInteger)segment;

设置标签图片

  • (void)setImage:(UIImage *)image forSegmentAtIndex:(NSUInteger)segment;

获取标签图片

  • (UIImage *)imageForSegmentAtIndex:(NSUInteger)segment;

注意:标题的图片只能设置一个

根据索引设置相应标签宽度

  • (void)setWidth:(CGFloat)width forSegmentAtIndex:(NSUInteger)segment;
    注意:如果设置为0.0,则为自适应,默认为此设置。

根据索引获取标签宽度

  • (CGFloat)widthForSegmentAtIndex:(NSUInteger)segment;

设置标签内容的偏移量

  • (void)setContentOffset:(CGSize)offset forSegmentAtIndex:(NSUInteger)segment;

注意:这个偏移量指的是标签的文字或者图片

根据索引获取变标签内容的偏移量

  • (CGSize)contentOffsetForSegmentAtIndex:(NSUInteger)segment;

根据所以设置标签是否有效(默认有效)

  • (void)setEnabled:(BOOL)enabled forSegmentAtIndex:(NSUInteger)segment;

根据索引获取当前标签是否有效

  • (BOOL)isEnabledForSegmentAtIndex:(NSUInteger)segment;

设置和获取当前选中的标签索引

@property(nonatomic) NSInteger selectedSegmentIndex;

设置标签风格颜色

@property(nonatomic,retain) UIColor *tintColor;

注意:这个风格颜色会影响标签的文字和图片

设置特定状态下segment的背景图案

  • (void)setBackgroundImage:(UIImage *)backgroundImage forState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics

注意:UIBarMetrics是一个枚举,如下:(defaulf风格会充满背景)

typedef NS_ENUM(NSInteger, UIBarMetrics) {
UIBarMetricsDefault,
UIBarMetricsCompact,
UIBarMetricsDefaultPrompt = 101, // Applicable only in bars with the prompt property, such as UINavigationBar and UISearchBar
UIBarMetricsCompactPrompt,

UIBarMetricsLandscapePhone NS_ENUM_DEPRECATED_IOS(5_0, 8_0, "Use UIBarMetricsCompact instead") = UIBarMetricsCompact,
UIBarMetricsLandscapePhonePrompt NS_ENUM_DEPRECATED_IOS(7_0, 8_0, "Use UIBarMetricsCompactPrompt") = UIBarMetricsCompactPrompt,

};

获取背景图案

  • (UIImage *)backgroundImageForState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics

设置标签之间分割线的图案

  • (void)setDividerImage:(UIImage *)dividerImage forLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState barMetrics:(UIBarMetrics)barMetrics

获取标签之间分割线的图案

  • (UIImage *)dividerImageForLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState barMetrics:(UIBarMetrics)barMetrics

通过Attribute字符串属性字典设置标签标题

  • (void)setTitleTextAttributes:(NSDictionary *)attributes forState:(UIControlState)state

获取Attribute字符串属性字典

  • (NSDictionary *)titleTextAttributesForState:(UIControlState)state

自行设置标签内容的偏移量

  • (void)setContentPositionAdjustment:(UIOffset)adjustment forSegmentType:(UISegmentedControlSegment)leftCenterRightOrAlone barMetrics:(UIBarMetrics)barMetrics

注意:UIOffset为偏移量,这个结构体中又两个浮点数,分别表示水平量和竖直量;UISegmentedControlSegment类型参数是一个枚举,如下:

typedef NS_ENUM(NSInteger, UISegmentedControlSegment) {
UISegmentedControlSegmentAny = 0,//所有标签都受影响
UISegmentedControlSegmentLeft = 1, //只有左边部分受到影响
UISegmentedControlSegmentCenter = 2, // 只有中间部分受到影响
UISegmentedControlSegmentRight = 3, // 只有右边部分受到影响
UISegmentedControlSegmentAlone = 4, // 在只有一个标签的时候生效
};

获取自定义偏移量

  • (UIOffset)contentPositionAdjustmentForSegmentType:(UISegmentedControlSegment)leftCenterRightOrAlone barMetrics:(UIBarMetrics)barMetrics

添加点击事件

[segmentedControl addTarget:self action:@selector(change:) forControlEvents:UIControlEventValueChanged];

专注技术,热爱生活,交流技术,也做朋友。

——珲少 QQ群:203317592